home *** CD-ROM | disk | FTP | other *** search
/ C!T ROM 3 / ct-rom iiib.zip / ct-rom iiib / WINDOWS / DIVERSEN / WINE02BX / TEXINFO.4 < prev    next >
Text File  |  1993-03-28  |  35KB  |  862 lines

  1. Info file ../info/texinfo, produced by Makeinfo, -*- Text -*- from
  2. input file texinfo.texinfo.
  3.  
  4. This file documents Texinfo, a documentation system that uses a
  5. single source file to produce both on-line help and a printed manual.
  6.  
  7. This is edition 1.1 of the Texinfo documentation, and is for the
  8. Texinfo that is distributed as part of Version 18 of GNU Emacs.
  9.  
  10. Copyright (C) 1988 Free Software Foundation, Inc.
  11.  
  12. Permission is granted to make and distribute verbatim copies of this
  13. manual provided the copyright notice and this permission notice are
  14. preserved on all copies.
  15.  
  16. Permission is granted to copy and distribute modified versions of
  17. this manual under the conditions for verbatim copying, provided that
  18. the entire resulting derived work is distributed under the terms of a
  19. permission notice identical to this one.
  20.  
  21. Permission is granted to copy and distribute translations of this
  22. manual into another language, under the above conditions for modified
  23. versions, except that this permission notice may be stated in a
  24. translation approved by the Foundation.
  25.  
  26.  
  27. 
  28. File: texinfo,  Node: Using texinfo-show-structure,  Next: Running Info-Validate,  Prev: Debugging with Tex,  Up: Catching Mistakes
  29.  
  30. Using `texinfo-show-structure'
  31. ==============================
  32.  
  33. It is not always easy to keep track of the nodes, chapters, sections
  34. and subsections of a Texinfo file.  This is especially true if you
  35. are revising or adding to a Texinfo file that someone else has written.
  36.  
  37. In GNU Emacs, in Texinfo mode, there is a command that will list all
  38. the lines that begin with the @-commands that specify the structure:
  39. @node, @chapter, @section, @appendix and so on.  This is the
  40. `texinfo-show-structure' command.  It is bound to the keyboard
  41. command `C-c C-s'.  `texinfo-show-structure' displays the lines that
  42. begin with the node and chapter structuring @-commands in another
  43. window called the `*Occur*' buffer.  For example, when
  44. `texinfo-show-structure' is run on the first part of this chapter, it
  45. produces the following:
  46.  
  47.      Lines matching
  48.      "^@\\(chapter\\|unnum\\|appendix\\|sect\\|sub\\|heading\\|major
  49.      \\|node\\)" in buffer new-texinfo-manual.texinfo.
  50.        2:@node     catching mistakes, @-Command Syntax, running info, top
  51.        4:@chapter Catching Mistakes
  52.       41:@node debugging with info, debugging with tex, , catching mistakes
  53.       43:@section Catching errors with Info Formatting
  54.  
  55. This means that lines 2, 4, 41 and 43 began with `@node', `@chapter',
  56. `@node', and `@section' respectively.  If you move your cursor into
  57. the `*Occur*' window, you can position the cursor over one of the
  58. lines and use the `C-c C-c' command (`occur-mode-goto-occurrence'),
  59. to jump to the corresponding spot in the Texinfo file.  *Note :
  60. (emacs)Other Repeating Search,  for more information about
  61. `occur-mode-goto-occurrence'.
  62.  
  63. The first line in the `*Occur*' window describes the "regular
  64. expression" specified by TEXINFO-HEADING-PATTERN.  This regular
  65. expression is the pattern that `texinfo-show-structure' looks for. 
  66. *Note : (emacs)Regexps, for more information.
  67.  
  68. When you give the `texinfo-show-structure' command, it will show the
  69. structure of the whole buffer.  If you want to see the structure of
  70. just a part of the buffer, of one chapter, for example, use the `C-x
  71. n' (`narrow-to-region') command to mark the region.  (*Note :
  72. (emacs)Narrowing.)  This is how the example used above was generated.
  73. (To see the whole buffer again, use `C-x w' (`widen').)
  74.  
  75. You can remind yourself of the structure of a Texinfo file by looking
  76. at the list in the `*Occur*' window; and if you have mis-named a node
  77. or left out a section, you can correct the mistake.
  78.  
  79. * Menu:
  80.  
  81. * Using Occur::
  82.  
  83.  
  84. 
  85. File: texinfo,  Node: Using Occur,  Prev: Using texinfo-show-structure,  Up: Using texinfo-show-structure
  86.  
  87. Using `occur'
  88. -------------
  89.  
  90. Sometimes the `texinfo-show-structure' command produces too much
  91. information.  Perhaps you want to remind yourself of the overall
  92. structure of a Texinfo file, and are overwhelmed by the detailed list
  93. produced by `texinfo-show-structure'.  In this case, you can use the
  94. `occur' command itself.  To do this, type
  95.  
  96.      `M-x occur'
  97.  
  98. and then, when prompted, type a "regexp", a regular expression for
  99. the pattern you want to match.   (*Note : (emacs)Regexps.) `occur'
  100. works from the current location of the cursor in the buffer to the
  101. end of the buffer.  If you want to run `occur' on the whole buffer,
  102. place the cursor at the beginning of the buffer.  For example, to see
  103. all the lines that contain the word `@chapter' in them, just type
  104. `@chapter'.  This will produce a list of the chapters.  It will also
  105. list all the sentences with `@chapter' in the middle of the line.  If
  106. you want to see only those lines that start with the word `@chapter',
  107. type `^@chapter' when prompted by `occur'.  If you want to see all
  108. the lines that end with a word or phrase, end the last word with a
  109. `$'; for example, `catching mistakes$'.  This can be helpful when you
  110. want to see all the nodes that are part of the same chapter or
  111. section and therefore have the same `Up' pointer.
  112.  
  113. *Note : (emacs)Other Repeating Search, for more information.
  114.  
  115.  
  116. 
  117. File: texinfo,  Node: Running Info-Validate,  Prev: Using texinfo-show-structure,  Up: Catching Mistakes
  118.  
  119. Finding Badly Referenced Nodes
  120. ==============================
  121.  
  122. You can check whether any of the `Next', `Previous', `Up' or other
  123. node pointers fail to point to a node with the `Info-validate' command.
  124. This command checks that every node pointer points to an existing node.
  125.  
  126. To use this command, you first need to load the `info' library and
  127. then do `M-x Info-validate'.
  128.  
  129.      `M-x load-library RET info RET' 
  130.      `M-x Info-validate'
  131.  
  132. (Note that all the `Info' commands require an uppercase `I'.)
  133.  
  134. If your file is ok, you will receive a message that says "File
  135. appears valid".  However, if you have a pointer that does not point
  136. to a node, error messages will be displayed in a buffer called
  137. `*problems in info file*'.
  138.  
  139. For example, `Info-validate' was run on a test file that contained
  140. only the first node of this manual.  One of the messages said:
  141.  
  142.      In node "Overview", invalid Next: Texinfo Mode
  143.  
  144. This meant that the node called `Overview' had a `Next' pointer that
  145. did not point to anything (which was true in this case, since the
  146. test file had only one node in it).
  147.  
  148. Now suppose we add a node named `Texinfo Mode' to our test case but
  149. we don't specify a `Previous' for this node.  Then we will get the
  150. following error message:
  151.  
  152.      In node "Texinfo Mode", should have Previous: Overview
  153.  
  154. This is because every `Next' pointer should be matched by a
  155. `Previous' (in the node where the `Next' points) which points back.
  156.  
  157. `Info-validate' also checks that all menu items and cross-references
  158. point to actual nodes.
  159.  
  160. Significantly, `Info-validate' does not work with large files that
  161. have been split.  (Info thinks of a large file as being over 100,000
  162. bytes, approximately.)  In order to use `Info-validate' on a large
  163. file, you must run `texinfo-format-buffer' with an argument so that
  164. it does not split the Info file, and then create a tag table.
  165.  
  166. * Menu:
  167.  
  168. * Info-Validating a Large File:: Running `Info-validate' on a large file.
  169. * Splitting::                    Splitting a file manually.
  170.  
  171.  
  172. 
  173. File: texinfo,  Node: Info-Validating a Large File,  Next: Splitting,  Prev: Running Info-Validate,  Up: Running Info-Validate
  174.  
  175. Running `Info-validate' on a Large File.
  176. ----------------------------------------
  177.  
  178. You can run `Info-validate' only on a single Info file.  The command
  179. will not work on indirect subfiles that are generated when the master
  180. file is split.  If you have a large file (longer than 100,000 bytes),
  181. you need to run the `texinfo-format-buffer' command in such a way
  182. that it does not create indirect subfiles.  You will also need to
  183. create a tag table.  When you have done this, you can run
  184. `Info-validate' and look for badly referenced nodes.
  185.  
  186. After you have validated the node structure, you can rerun
  187. `texinfo-format-buffer' in the normal way so it will construct the
  188. tag table and split the file automatically or, you can make the tag
  189. table and split the file manually.
  190.  
  191. To prevent the `texinfo-format-buffer' command from splitting a
  192. Texinfo file into smaller Info files, give a prefix to the `M-x
  193. texinfo-format-buffer' command:
  194.  
  195.      C-u  M-x texinfo-format-buffer
  196.  
  197. When you do this, Texinfo will not split the file and will not create
  198. a tag table for it.
  199.  
  200. Before you can run `M-x Info-validate' on the Info file, you need to
  201. create a tag table for it.  In order to do this, you first need to
  202. load the `info' library into Emacs with the following command:
  203.  
  204.      M-x load-library RET info RET
  205.  
  206. Then you can give the command:
  207.  
  208.      M-x Info-tagify
  209.  
  210. This creates a file which you can validate.
  211.  
  212.      M-x Info-validate
  213.  
  214. After you have checked the validity of the nodes, you can either run
  215. `M-x texinfo-format-buffer' as you would normally, or else tagify and
  216. split the file manually with the two commands `Info-tagify' and
  217. `Info-split'.
  218.  
  219.  
  220. 
  221. File: texinfo,  Node: Splitting,  Prev: Info-Validating a Large File,  Up: Running Info-Validate
  222.  
  223. Splitting a File Manually
  224. -------------------------
  225.  
  226. If the file has more than 100,000 or so bytes in it, you should split
  227. it or else let the `texinfo-format-buffer' command do it for you
  228. automatically.  (Generally you will let `texinfo-format-buffer' do
  229. this job for you.  *Note Creating an Info File::.)
  230.  
  231. The split off files are called the indirect subfiles.
  232.  
  233. Info files are split to save memory.  With smaller files, Emacs does
  234. not have make such a large buffer to hold the information.  This way,
  235. Emacs can save memory.
  236.  
  237. If the Info file has more than 30 nodes, you should also make a tag
  238. table for it. *Note Info-Validating a Large File::, for information
  239. about creating a tag table.
  240.  
  241. Before running `Info-split', you need to load the `info' library into
  242. Emacs by giving the command `M-x load-library RET info RET'.  After
  243. you have done this, you can give the two commands:
  244.  
  245.      M-x Info-tagify
  246.      M-x Info-split
  247.  
  248. (Note that the `I' in `Info' is uppercase.)
  249.  
  250. When you use the `Info-split' command, the buffer is modified into a
  251. (small) Info file which lists the indirect subfiles.  This file
  252. should be saved in place of the original visited file.  The indirect
  253. subfiles are written in the same directory the original file is in,
  254. with names generated by appending `-' and a number to the original
  255. file name.
  256.  
  257. The primary file still functions as an Info file, but it contains
  258. just the tag table and a directory of subfiles.
  259.  
  260.  
  261. 
  262. File: texinfo,  Node: Command Syntax,  Next: Include Files,  Prev: Catching Mistakes,  Up: Top
  263.  
  264. @-Command Syntax
  265. ****************
  266.  
  267. The character `@' is used to start special Texinfo commands.  (It has
  268. the same meaning that `\' has in plain TeX.)  Syntactically, there
  269. are three classes of @-commands:
  270.  
  271. 1. Non-alphabetic commands: @ followed by a punctuation character.
  272.       These commands are always part of the text within a paragraph,
  273.      and never take any argument.  The two characters (@ and the
  274.      other one) are complete in themselves.  For example, `@.', `@:',
  275.      `@{' and `@}'.
  276.  
  277. 2. Alphabetic commands used within a paragraph.
  278.       These commands have @ followed by a letter or a word, followed
  279.      by an argument within braces.  For example, the command `@dfn'
  280.      indicates the introductory or defining use of a term; it is used
  281.      as follows: `In Texinfo, @-commands are @dfn{mark-up} commands.'
  282.  
  283. 3. Alphabetic commands used outside of paragraphs.
  284.       Each such command occupies an entire line.  The line starts with
  285.      @, followed by the name of the command (a word) such as
  286.      `@center' or `@cindex'.  If no argument is needed, the word is
  287.      followed by the end of the line.  If there is an argument, it is
  288.      separated from the command name by a space.
  289.  
  290. Thus, the alphabetic commands fall into two classes that have
  291. different argument syntax.  You cannot tell which class a command
  292. falls in by the appearance of its name, but you can tell by the
  293. command's meaning: if it makes sense to use the command together with
  294. other words as part of a paragraph, the command is in class 2 and
  295. must be followed by an argument in braces; otherwise, it is in class
  296. 3 and uses the rest of the line as its argument.
  297.  
  298. The purpose of having different syntax for commands of classes 2 and
  299. 3 is to make the Texinfo file easier to read, and also to help the
  300. GNU Emacs paragraph and filling commands work properly.  There is
  301. only one exception to this rule: the command `@refill', which is
  302. always used at the end of a paragraph immediately following the final
  303. period or other punctuation character.  `@refill' takes no argument. 
  304. `@refill' never confuses the Emacs paragraph commands because it
  305. cannot start at the beginning of a line.
  306.  
  307.  
  308. 
  309. File: texinfo,  Node: Include Files,  Next: TeX Input,  Prev: Command Syntax,  Up: Top
  310.  
  311. Include Files
  312. *************
  313.  
  314. When Info was first created, it was customary to create many small
  315. Info files on one subject.  By doing this, Emacs did not have to make
  316. a large buffer to hold the whole of a large Info file; instead, Emacs
  317. allocated just enough memory for the small Info file that was needed
  318. at the time.  This way, Emacs could avoid wasting memory.  Include
  319. files were designed as a way to create a single, large printed manual
  320. out of several smaller Info files.
  321.  
  322. However, because large Info files can now be split, include files are
  323. no longer strictly necessary and they are used infrequently.  Most
  324. often, they are now used in projects where several different people
  325. are writing different sections of a document simultaneously.
  326.  
  327. How Include Files Work
  328. ======================
  329.  
  330. In a Texinfo file, a line of the form `@include `filename'' is
  331. ignored when the Info file is generated, but in a printed manual it
  332. causes the contents of the file `filename' to be processed and
  333. included in the manual.  The contents of the file `filename' can be
  334. ignored by Info because the first file can refer to `filename' with
  335. menus as well as cross references.  In the Info system, all the
  336. information is, as it were, `in one place'.  However, when two
  337. printed manuals are made from two separate Texinfo files, the two
  338. manuals are separate, and even if they give each other as references,
  339. the references are to separate documents.  Consequently, you will
  340. sometimes want to create a comprehensive, printed manual that
  341. contains all the necessary information together in one place.
  342.  
  343. `@include' files are special Texinfo files that are used only for
  344. making such a comprehensive manual.  They are listed inside an outer
  345. file that contains nothing but the beginning and end matter of a
  346. Texinfo file and a number of `@include' commands listing the included
  347. files.
  348.  
  349. An `@include' file--a file that will be listed inside an outer file
  350. and processed with the `@include' command--should not start with
  351. `\input texinfo', as that has already been done by the outer file,
  352. and the character `\' has already been redefined to generate a
  353. backslash in the output.  Instead, an `@include' file usually begins
  354. with a node; it lacks the beginning and ending of a Texinfo file that
  355. are described in the chapters on beginning and ending a file.  *Note
  356. Beginning a File::, and *note Ending a File::.
  357.  
  358. Likewise, an `@include' file should not end with `@bye', since that
  359. would terminate TeX processing immediately.
  360.  
  361. Here is an example of a outer Texinfo file with `@include' files
  362. within it:
  363.  
  364.      \input texinfo @c -*-texinfo-*-
  365.      @setfilename  include 
  366.      @settitle Include Manual
  367.      
  368.      @setchapternewpage odd
  369.      @titlepage
  370.      @sp 12
  371.      @center @titlefont{Include Manual}
  372.      @sp 2
  373.      @center by Whom Ever
  374.      
  375.      @page
  376.      Copyright @copyright{} 1988 Free Software Foundation, Inc.
  377.      @end titlepage
  378.      
  379.      @include foo.texinfo
  380.      @include bar.texinfo
  381.      
  382.      @unnumbered Concept Index
  383.      @printindex cp
  384.      
  385.      @summarycontents
  386.      @contents
  387.      
  388.      @bye
  389.  
  390.  
  391. 
  392. File: texinfo,  Node: TeX Input,  Next: Sample Permissions,  Prev: Include Files,  Up: Top
  393.  
  394. TeX Input Initialization
  395. ************************
  396.  
  397. You must put an input command on the first line of every Texinfo file
  398. to tell TeX to use the `texinfo.tex' file when it is processing the
  399. Texinfo source file.  Otherwise TeX will not know what to do with the
  400. @-commands.  (The TeX input command is written as `\input texinfo'. 
  401. *Note First Line::.)
  402.  
  403. TeX needs to be told where to find the `texinfo.tex' file that you
  404. have told it to input.  The preferred way to do this is to put
  405. `texinfo.tex' in the default inputs directory, which is the
  406. `/usr/lib/tex/macros' directory.  If this is done (as it usually is
  407. when GNU Emacs is installed), TeX will find the file and you don't
  408. have to do anything.  Alternatively, you can put `texinfo.tex' in the
  409. directory in which the Texinfo source file is located.
  410.  
  411. However, you may want to specify the location of the `\input' file
  412. yourself.  One way to do this is to write the complete path for the
  413. file after the `\input' command.  Another way is to set the
  414. `TEXINPUTS' environment variable in your `.cshrc' or `.profile' file.
  415. The `TEXINPUTS' environment variable will tell TeX where to find the
  416. `texinfo.tex' file and any other file that you might want TeX to use.
  417.  
  418. Whether you use a `.cshrc' or `.profile' file depends on whether you
  419. use `csh' or `sh' for your shell command interpreter.  When you use
  420. `csh', it looks to the `.cshrc' file for initialization information,
  421. and when you use `sh', it looks to the `.profile' file.
  422.  
  423. In a `.cshrc' file, you could use the following `csh' command sequence:
  424.  
  425.      setenv TEXINPUTS .:/usr/me/mylib:/usr/lib/tex/macros
  426.  
  427. In a `.profile' file, you could use the following `sh' command
  428. sequence:
  429.  
  430.      TEXINPUTS=.:/usr/me/mylib:/usr/lib/tex/macros
  431.      export TEXINPUTS
  432.  
  433. This would cause TeX to look for `\input' file first in the current
  434. directory, indicated by the `.', then in a hypothetical user's
  435. `me/mylib' directory, and finally in the system library.
  436.  
  437.  
  438. 
  439. File: texinfo,  Node: Sample Permissions,  Next: Command Index,  Prev: TeX Input,  Up: Top
  440.  
  441. Standard text for Copying Permissions
  442. *************************************
  443.  
  444. Texinfo files should contain sections that tell the readers that they
  445. have the right to copy and distribute the Info file, the printed
  446. manual and any accompanying software.  This appendix contains the
  447. standard text of the Free Software Foundation copying permission
  448. notice.  For an example of the text that could be used for the
  449. Distribution, General Public License and NO WARRANTY sections of a
  450. document, see the latest version of the ``GNU Emacs Manual''.
  451.  
  452. The texts of the Free Software Foundation copying permission notice
  453. in the `@ifinfo' section and in the `@titlepage' section are slightly
  454. different.
  455.  
  456. The `@ifinfo' section usually begins with a line that says what the
  457. file documents.  This is what a person looking at the file will first
  458. read if he or she reads the unprocessed Texinfo file or if he or she
  459. uses the advanced Info command `g *'.  *note info: (info)Expert, for
  460. more information. (If the reader uses the regular Info commands, he
  461. or she will usually start reading at the first node and skip this
  462. first section, which is not in a node.)
  463.  
  464. In the `@ifinfo' section, the summary sentence should be followed by
  465. a copyright notice and then by the copying permission notice.  One of
  466. the copying permission paragraphs is enclosed in `@ignore' and `@end
  467. ignore' commands.  This paragraph states that the Texinfo file can be
  468. processed through TeX and printed, provided the printed manual
  469. carries the proper copying permission notice.  This paragraph is not
  470. made part of the Info file since it is not relevant to the Info file;
  471. but it is a mandatory part of the Texinfo file since it permits
  472. people to process the Texinfo file in TeX.
  473.  
  474. In the printed manual, the Free Software Foundation copying
  475. permission notice follows the copyright notice and publishing
  476. information and is located within the region delineated by the
  477. `@titlepage' and `@end titlepage' commands.  The copying permission
  478. notice is exactly the same as the notice in the `@ifinfo' section
  479. except that the paragraph enclosed in `@ignore' and `@end ignore'
  480. commands is not part of the notice.
  481.  
  482. To make it simpler to copy the permission notice into each section of
  483. the Texinfo file, the complete permission notices for each section
  484. are reproduced in full below even though most of the information is
  485. redundant.
  486.  
  487. Note that you my have to specify the correct name of a section
  488. mentioned in the permission notice.  For example, in the ``GDB
  489. Manual'', the name of the section referring to the General Public
  490. License is called the "GDB General Public License", but in the sample
  491. shown below, that section is referred to generically as the "General
  492. Public License".
  493.  
  494. * Menu:
  495.  
  496. * Ifinfo Permissions::
  497. * Titlepage Permissions::
  498.  
  499.  
  500. 
  501. File: texinfo,  Node: Ifinfo Permissions,  Next: Titlepage Permissions,  Prev: Sample Permissions,  Up: Sample Permissions
  502.  
  503. Ifinfo Copying Permissions
  504. ==========================
  505.  
  506. In the `@ifinfo' section of the Texinfo file, the standard Free
  507. Software Foundation permission notices reads as follows:
  508.  
  509.      This file documents ...
  510.      
  511.      Copyright 1988 Free Software Foundation, Inc.
  512.      
  513.      Permission is granted to make and distribute verbatim copies of
  514.      this manual provided the copyright notice and this permission notice
  515.      are preserved on all copies.
  516.      
  517.      @ignore
  518.      Permission is granted to process this file through TeX and print the
  519.      results, provided the printed document carries a copying permission
  520.      notice identical to this one except for the removal of this paragraph
  521.      (this paragraph not being relevant to the printed manual).
  522.      
  523.      @end ignore
  524.      Permission is granted to copy and distribute modified versions of this
  525.      manual under the conditions for verbatim copying, provided also that the
  526.      sections entitled ``Distribution'' and ``General Public License'' are
  527.      included exactly as in the original, and provided that the entire
  528.      resulting derived work is distributed under the terms of a permission
  529.      notice identical to this one.
  530.      
  531.      Permission is granted to copy and distribute translations of this manual
  532.      into another language, under the above conditions for modified versions,
  533.      except that the sections entitled ``Distribution'' and ``General Public
  534.      License'' may be included in a translation approved by the author instead
  535.      of in the original English.
  536.  
  537.  
  538. 
  539. File: texinfo,  Node: Titlepage Permissions,  Prev: Ifinfo Permissions,  Up: Sample Permissions
  540.  
  541. Titlepage Copying Permissions
  542. =============================
  543.  
  544. In the `@titlepage' section of the Texinfo file, the standard Free
  545. Software Foundation copying permission notices follows the copyright
  546. notice and publishing information.  The standard phrasing is:
  547.  
  548.      Permission is granted to make and distribute verbatim copies of
  549.      this manual provided the copyright notice and this permission notice
  550.      are preserved on all copies.
  551.      
  552.      Permission is granted to copy and distribute modified versions of this
  553.      manual under the conditions for verbatim copying, provided also that the
  554.      sections entitled ``Distribution'' and ``General Public License'' are
  555.      included exactly as in the original, and provided that the entire
  556.      resulting derived work is distributed under the terms of a permission
  557.      notice identical to this one.
  558.      
  559.      Permission is granted to copy and distribute translations of this manual
  560.      into another language, under the above conditions for modified versions,
  561.      except that the sections entitled ``Distribution'' and ``General Public
  562.      License'' may be included in a translation approved by the author instead
  563.      of in the original English.
  564.  
  565.  
  566. 
  567. File: texinfo,  Node: Command Index,  Next: Concept Index,  Prev: Sample Permissions,  Up: Top
  568.  
  569. Command Index
  570. *************
  571.  
  572. (When used in a Texinfo file, @-commands are preceded by an `@'.)
  573.  
  574. * Menu:
  575.  
  576. * *: Line Breaks.
  577. * TeX: Tex.
  578. * appendix: Unnumbered and Appendix.
  579. * appendixsec: Section.
  580. * appendixsubsec: Subsection.
  581. * appendixsubsubsec: Subsubsection.
  582. * asterisk: Line Breaks.
  583. * at-sign colons: Insert Colon.
  584. * at-sign periods: Insert Period.
  585. * at-signs: Inserting An Atsign.
  586. * b (bold font): Fonts.
  587. * br (paragraph breaks): Br.
  588. * bullet: Bullet.
  589. * bye: Ending a File.
  590. * center: Center.
  591. * chapter: Chapter.
  592. * cite: Cite.
  593. * code: Code.
  594. * copyright: Copyright & Printed Permissions.
  595. * ctrl: Ctrl.
  596. * dfn: Dfn.
  597. * display: Display.
  598. * dots: Dots.
  599. * emph: Emph and Strong.
  600. * end: Lists and Tables.
  601. * end: Quotations and Examples.
  602. * enumerate: Enumerate.
  603. * example: Example.
  604. * file: File.
  605. * filll: Copyright & Printed Permissions.
  606. * group: Group.
  607. * i (italic font): Fonts.
  608. * ifinfo: Conditionals.
  609. * iftex: Conditionals.
  610. * inforef: Inforef.
  611. * item: Itemize.
  612. * item: Table.
  613. * itemize: Itemize.
  614. * itemx: Itemx.
  615. * kbd: Kbd.
  616. * key: Key.
  617. * left-braces: Insert Left Brace.
  618. * menu: Menu.
  619. * need: Need.
  620. * node: Structuring.
  621. * noindent: Noindent.
  622. * page: Page.
  623. * pxref: Pxref.
  624. * quotation: Quotation.
  625. * refill: Refill.
  626. * right-braces: Insert Left Brace.
  627. * samp: Samp.
  628. * section: Section.
  629. * setchapternewpage: Setchapternewpage.
  630. * setfilename: Setfilename.
  631. * settitle: Settitle.
  632. * sp (line spacing): Sp.
  633. * start-of-header: Start-of-Header.
  634. * strong: Emph and Strong.
  635. * subsection: Subsection.
  636. * subsubsection: Subsubsection.
  637. * t (typewriter font): Fonts.
  638. * table: Table.
  639. * texindex (for sorting indices): Printing Hardcopy.
  640. * texinfo-format-buffer: Creating an Info File.
  641. * texinfo-format-region: Info on a Region.
  642. * texinfo-show-structure: Using texinfo-show-structure.
  643. * titlefont: Titlepage.
  644. * titlepage: Titlepage.
  645. * unnumbered: Unnumbered and Appendix.
  646. * unnumberedsec: Section.
  647. * unnumberedsubsec: Subsection.
  648. * unnumberedsubsubsec: Subsubsection.
  649. * var: Var.
  650. * vskip: Copyright & Printed Permissions.
  651. * w (preventing a line break): W.
  652. * xref: Xref.
  653.  
  654.  
  655.  
  656. 
  657. File: texinfo,  Node: Concept Index,  Prev: Command Index,  Up: Top
  658.  
  659. Concept Index
  660. *************
  661.  
  662. * Menu:
  663.  
  664. * @-Command Syntax: Command Syntax.
  665. * Badly referenced nodes: Running Info-Validate.
  666. * Beginning a Texinfo file: Beginning a File.
  667. * Beginning line of a Texinfo file: First Line.
  668. * Braces, inserting: Braces Atsigns Periods.
  669. * Breaks in a line: Line Breaks.
  670. * Breaks in a paragraph: Br.
  671. * Bullets, inserting: Dots Bullets Tex.
  672. * Catching errors with Info Formatting: Debugging with Info.
  673. * Catching errors with TeX Formatting: Debugging with Tex.
  674. * Catching mistakes: Catching Mistakes.
  675. * Centering a line: Center.
  676. * Chapter structuring: Structuring.
  677. * Characteristics of the Info file: Info File.
  678. * Characteristics, printed manual: Printed Manual.
  679. * Checking for badly referenced nodes: Running Info-Validate.
  680. * Combining Indices: Combining Indices.
  681. * Commands to insert single characters: Braces Atsigns Periods.
  682. * Commands, inserting them: Inserting.
  683. * Commands, specifying them within text: Specifying.
  684. * Compile command for formatting: Compile-Command.
  685. * Conditionals: Conditionals.
  686. * Contents, Table of: Contents.
  687. * Conventions, syntactic: Conventions.
  688. * Copying permissions: Sample Permissions.
  689. * Copyright: Copyright & Printed Permissions.
  690. * Copyright page: Titlepage & Copyright Page.
  691. * Correcting mistakes: Catching Mistakes.
  692. * Creating an on-line Info file: Creating an Info File.
  693. * Creating indices: Indices.
  694. * Cross references: Cross References.
  695. * Cross references using inforef: Inforef.
  696. * Cross references using pxref: Pxref.
  697. * Cross references using xref: Xref.
  698. * Debugger, using the Emacs Lisp: Using the Emacs Lisp Debugger.
  699. * Debugging the Texinfo structure: Catching Mistakes.
  700. * Debugging with Info Formatting: Debugging with Info.
  701. * Debugging with TeX Formatting: Debugging with Tex.
  702. * Defining the entries of an index: Index Entries.
  703. * Definitions, specifying them within text: Specifying.
  704. * Dir directory for Info installation: Installing an Info File.
  705. * Display: Display.
  706. * Distribution: License and Distribution.
  707. * Dots, inserting: Dots Bullets Tex.
  708. * Dots, inserting: Dots.
  709. * Emacs: Texinfo Mode.
  710. * Emacs Lisp debugger: Using the Emacs Lisp Debugger.
  711. * Emphasizing text: Emphasis.
  712. * Ending a Texinfo file: Ending a File.
  713. * Entries for an index: Index Entries.
  714. * Enumerate: Enumerate.
  715. * Examples: Example.
  716. * Examples: Quotations and Examples.
  717. * File beginning: Beginning a File.
  718. * File ending: Ending a File.
  719. * File structure, showing it: Showing the Structure.
  720. * Files, specifying them within text: Specifying.
  721. * Finding badly referenced nodes: Running Info-Validate.
  722. * First line of a Texinfo file: First Line.
  723. * Formatting a file for Info: Creating an Info File.
  724. * Formatting paragraphs: Formatting Paragraphs.
  725. * Formatting requirements: Requirements.
  726. * Formatting with the compile command: Compile-Command.
  727. * Frequently used commands, inserting them: Inserting.
  728. * GNU Emacs: Texinfo Mode.
  729. * General syntactic conventions: Conventions.
  730. * Generating menus with indices: Printing Indices & Menus.
  731. * Group: Group.
  732. * Hardcopy, printing it: Printing Hardcopy.
  733. * Header for Texinfo files: Header.
  734. * Highlighting: Specifying.
  735. * Holding text together vertically: Group.
  736. * Ifinfo: Conditionals.
  737. * Ifinfo permissions: Ifinfo Permissions.
  738. * Iftex: Conditionals.
  739. * Include files: Include Files.
  740. * Index entries: Index Entries.
  741. * Indices: Indices.
  742. * Indices, combining them: Combining Indices.
  743. * Indices, printing: Printing Indices & Menus.
  744. * Indices, sorting: Printing Hardcopy.
  745. * Indices, two letter names: Combining Indices.
  746. * Indirect subfiles: Creating an Info File.
  747. * Info file characteristics: Info File.
  748. * Info file installation: Installing an Info File.
  749. * Info file requirement for @setfilename: Setfilename.
  750. * Info file, splitting manually: Splitting.
  751. * Info validating a large file: Info-Validating a Large File.
  752. * Info, creating an on-line file: Creating an Info File.
  753. * Info, formatting on a region: Info on a Region.
  754. * Info-validate,  running the command: Running Info-Validate.
  755. * Inforef for cross references: Inforef.
  756. * Inserting braces, @ and periods: Braces Atsigns Periods.
  757. * Inserting dots: Dots.
  758. * Inserting frequently used commands: Inserting.
  759. * Installing an Info file: Installing an Info File.
  760. * Itemize: Itemize.
  761. * Itemx: Itemx.
  762. * License agreement: License and Distribution.
  763. * Line breaks: Line Breaks.
  764. * Line breaks, preventing: W.
  765. * Line spacing: Sp.
  766. * Lists and tables, making them: Lists and Tables.
  767. * Local variables: Compile-Command.
  768. * Looking for badly referenced nodes: Running Info-Validate.
  769. * Making a printed manual: Printing Hardcopy.
  770. * Making a tag table manually: Info-Validating a Large File.
  771. * Making cross references: Cross References.
  772. * Making lists and tables: Lists and Tables.
  773. * Marking text within a paragraph: Marking Text.
  774. * Master menu: Top Node.
  775. * Menus: Menu.
  776. * Menus generated with indices: Printing Indices & Menus.
  777. * Mistakes, catching: Catching Mistakes.
  778. * Mode, using Texinfo: Texinfo Mode.
  779. * Names for indices: Combining Indices.
  780. * Need: Need.
  781. * Node and chapter structuring: Structuring.
  782. * Node structuring: Structuring.
  783. * Nodes, catching mistakes: Catching Mistakes.
  784. * Nodes, checking for badly referenced nodes: Running Info-Validate.
  785. * Nodes, correcting mistakes: Catching Mistakes.
  786. * Occur, using the command: Using Occur.
  787. * Overview of Texinfo: Overview.
  788. * Page breaks: Page.
  789. * Pages, starting odd: Setchapternewpage.
  790. * Paragraph breaks: Br.
  791. * Paragraphs, formatting: Formatting Paragraphs.
  792. * Periods, inserting: Braces Atsigns Periods.
  793. * Permissions: Sample Permissions.
  794. * Permissions, printed: Copyright & Printed Permissions.
  795. * Preface: License and Distribution.
  796. * Preventing indentation in the printed text: Refilling & Noindent.
  797. * Printed manual characteristics: Printed Manual.
  798. * Printed permissions: Copyright & Printed Permissions.
  799. * Printing an index: Printing Indices & Menus.
  800. * Printing hardcopy: Printing Hardcopy.
  801. * Problems, catching: Catching Mistakes.
  802. * Pxref for cross references: Pxref.
  803. * Quotations: Quotation.
  804. * Quotations: Quotations and Examples.
  805. * References: Cross References.
  806. * Refilling paragraphs automatically: Refilling & Noindent.
  807. * Requirements for formatting: Requirements.
  808. * Running Info: Creating an Info File.
  809. * Running Info on a region: Info on a Region.
  810. * Running Info-validate: Running Info-Validate.
  811. * Running Info-validate on a large file: Info-Validating a Large File.
  812. * Sample texinfo file: Short Sample.
  813. * Setfilename command: Setfilename.
  814. * Showing the structure of a file: Using texinfo-show-structure.
  815. * Showing the structure of a file: Showing the Structure.
  816. * Single characters,  commands to insert: Braces Atsigns Periods.
  817. * Sorting indices: Printing Hardcopy.
  818. * Spaces from line to line: Sp.
  819. * Special typesetting commands: Dots Bullets Tex.
  820. * Specifying commands, files and the like: Specifying.
  821. * Splitting an Info file manually: Splitting.
  822. * Starting chapters: Setchapternewpage.
  823. * Structure of Texinfo, catching mistakes: Catching Mistakes.
  824. * Structure of a file, showing it: Showing the Structure.
  825. * Structuring of nodes and chapters: Structuring.
  826. * Syntactic conventions: Conventions.
  827. * TEXINPUTS environment variable: TeX Input.
  828. * Table of contents: Contents.
  829. * Tables and lists, making them: Lists and Tables.
  830. * Tables, making two-column: Table.
  831. * Tag table, making manually: Info-Validating a Large File.
  832. * TeX Input Initialization: TeX Input.
  833. * TeX commands, using them: Using Tex Commands.
  834. * TeX-logo, inserting: Dots Bullets Tex.
  835. * Texinfo file beginning: Beginning a File.
  836. * Texinfo file ending: Ending a File.
  837. * Texinfo file header: Header.
  838. * Texinfo file structure, showing it: Showing the Structure.
  839. * Texinfo mode: Texinfo Mode.
  840. * Texinfo overview: Overview.
  841. * Titlepage: Titlepage.
  842. * Titlepage: Titlepage & Copyright Page.
  843. * Titlepage permissions: Titlepage Permissions.
  844. * Top node: Top Node.
  845. * Two letter names for indices: Combining Indices.
  846. * Typesetting commands for dots and the like: Dots Bullets Tex.
  847. * Using TeX commands: Using Tex Commands.
  848. * Using occur: Using Occur.
  849. * Using texinfo-show-structure to catch mistakes: Using texinfo-show-structure.
  850. * Using the Emacs Lisp debugger: Using the Emacs Lisp Debugger.
  851. * Validating a large file: Info-Validating a Large File.
  852. * Vertically holding text together: Group.
  853. * Xref for cross references: Xref.
  854. * cshrc initialization file: TeX Input.
  855. * end-of-header: End-of-Header.
  856. * profile initialization file: TeX Input.
  857. * start-of-header: Start-of-Header.
  858. * texinfo-show-structure for catching mistakes: Using texinfo-show-structure.
  859.  
  860.  
  861.  
  862.